home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 17 / AMIGAplus Sonderheft 17 (1999)(ICP)(DE)[!].iso / PD / Anwendungen / -DataTypes- / PCD / PCD-DT.doc < prev    next >
Text File  |  1998-08-09  |  4KB  |  142 lines
  1. Documentation of pcd.datatype 43.7
  2. ----------------------------------
  3.  
  4.  
  5. Introduction
  6. ------------
  7.  
  8. With the help of the pcd.datatype, your datatype sytem is able to read images
  9. from Photo-CD's.
  10.  
  11. This datatype is Freeware !
  12. Do with it what you want, as long as you do not remove any files from this archive !
  13.  
  14.  
  15. Requirements for pcd.datatype
  16. -----------------------------
  17.  
  18. * OS 3.x
  19. * MC68020 or better
  20. * A mounted PIPE: handler !!
  21. * The PCD decoder 'pcdtoppm' (included in this archive) in your path.
  22. * ixemul.library 39.x or better.
  23. * render.library 29.x or better.
  24.  
  25.  
  26. Additionally recommened
  27. -----------------------
  28.  
  29. * CyberGraphX with picture.datatype 43.x for 24-bit images.
  30.  
  31.  
  32. Requirements for PCDPrefs
  33. --------------------------
  34.  
  35. * OS 3.x
  36. * MC68020 or better
  37. * MUI 3.x
  38.  
  39.  
  40. Installation
  41. ------------
  42.  
  43. Simply click on the 'Install' script.
  44. As the pcd.datatype needs an external decoder, you must select a directory that
  45. is in your path to store the decoder !
  46. The installer will not check your configuration !
  47. You MUST store the decoder 'pcdtoppm' somewhere in your path, otherwise the datatype
  48. will hang up in an endless loop !!
  49.  
  50.  
  51. How does the pcd.datatype work ?
  52. ---------------------------------
  53.  
  54. The pcd.datatype is to small to be a standalone decoder.
  55. Whenever the superclass detects a PCD image, it opens the pcd.datatype.
  56. This launches the external PCD decoder 'pcdtoppm', which redirects its output
  57. to the PIPE-handler. The datatype simply reads the decoded RGB values from the
  58. PIPE handler and stores them in the bitmap.
  59.  
  60.  
  61. Preferences
  62. -----------
  63.  
  64. Mode:
  65.  -> V43 CGX Mode
  66.     Enables V43 CyberGraphX mode.
  67.     If you do not have the picture.datatype 43.x, the datatype will fall back to V40 mode.
  68.  -> V40 AGA Mode
  69.     Truecolor images will be color reduced for AGA.
  70.  
  71. Resolution:
  72. The PCD decoder is able to decompress a PCD image to different resolutions.
  73. The default is 768*512.
  74. The two highest resolutions don't make much sense as you need a fast CPU
  75. and lots of memory !
  76.  
  77. V40 Dithermode:
  78. Enables Floyd-Steinberg dithering (recommended ,1).
  79. Default is 'No dithering' (0).
  80.  
  81. V40 Depth:
  82. Depth to use for color reducing in AGA modes.
  83. Values are from 3 to 8 (default).
  84.  
  85. Currently I only support MUI for the preferences.
  86. If you don't have MUI, you also can adjust the preferences very easy.
  87. The ENV-variable 'DataTypes/pcd.prefs' contains the parameter as a DOS-argument
  88. with the template 'MODE/N,RESOLUTION/N,DITHER/N,DEPTH/N'.
  89. You can change the settings anytime either by using the 'SetEnv'-command or by
  90. using a text editor.
  91. A GadTools version of the preferences may follow in the near future.
  92.  
  93.  
  94. History
  95. -------
  96.  
  97. 01-Dec-97  V43.0
  98.    * First public release
  99.  
  100. 04-Dec-97  V43.1
  101.    * Works under non-CyberGraphX systems too.
  102.  
  103. 03-Mar-98  V43.2
  104.     * Datatype is now able to reduce colors of 24-bit images with the render.library.
  105.    * Added MUI preferences (no GadTools version, I'm too lazy for it).
  106.    * Added NewIcons to the archive.
  107.  
  108. 09-Mar-98  V43.3
  109.    * Preferences' resolution is now a cycle gadget with text.
  110.  
  111. 17-Mar-98  V43.4
  112.    * Improved method handling.
  113.  
  114. 18-Mar-98  V43.5
  115.    * Shortened file size.
  116.    * More error handling.
  117.  
  118. 09-Apr-98  V43.6
  119.    * Added render.library to archive.
  120.    * Ops ! Forgot, that datatypes requires ixemul.library. Sorry !
  121.  
  122. 20-Jul-98  V43.7
  123.    * Included new render.library 29.0.
  124.      PCD-Datatype new requires this new version.
  125.  
  126.  
  127. Credits
  128. -------
  129.  
  130. Timm S. Müller for the render.library.
  131.  
  132.  
  133. Author
  134. ------
  135.  
  136. Feel free to contact me for comments, critics or bug reports !
  137.  
  138. Name:     Achim Stegemann
  139. Email:    astegema@ix.urz.uni-heidelberg.de
  140. Internet: http://www.rzuser.uni-heidelberg.de/~astegema
  141.  
  142.